2.2 Running the installation program

The installation program for the Self-Service App is provided in the following location within the MyID release:

MyID Clients\Self Service App\

Note: You do not need to have administrative privileges to install the Self-Service App. However, you must make sure that you have the correct permissions to install software to the program folder; for example, your system administrator may not permit you to install software to the default Program Files (x86)\Intercede\ folder. In this case, choose a different destination location during the installation process.

Note: Intercede also provides MSIX versions of the installation programs for MyID Desktop, the Self-Service App, and the MyID Client Service. These are intended for an administrator to create an installation package that combines all of the necessary client software and administrator-controlled configuration. See the MyID Client MSIX Installation Guide for details of working with these installation programs.

• IKB-359 – Issue when upgrading the Self-Service App from a previous version

  When you install the Self-Service App over a previous version, the application may fail to launch; no error is displayed. Windows system events may be recorded on the client workstation (event ID 1000 or 1026, relating to MyIDApp.exe). This issue is caused when the installation program cannot replace files in the program folder. As a workaround, uninstall the previous version of the application, delete the program folder (by default, C:\Program Files (x86)\Intercede\MyIDApp\) and then install the new version.

To install the Self-Service App on your client PC:

1. Copy the installation program to a local drive.

   If you do not run the installation program from a local drive, you may experience problems with the App running slowly due to certificate checks.

2. Run the .msi installer.
3. Click Next.

4. Select the destination location.

   By default, the Self-Service App installs to:

   C:\Program Files (x86)\Intercede\MyIDApp\

   On a 32-bit system, this is:

   C:\Program Files\Intercede\MyIDApp\

5. Click Next.

6. In the Server URL box, type the location of the server on which the MyID Web Services are installed.

   For example:

   https://myserver/

   Note: Make sure you use the correct protocol: http or https.

   If you want to configure the Self-Service App to be able to connect to multiple servers (for example, if you have a test server and a production server) you can specify multiple servers in the Server URL box separated by commas; for example:

   https://productionserver, https://testserver, https://testserver2

   By default, the Self-Service App connects to the first server in this list. If you want to connect to any of the other servers, you can specify the server address on the command line using the /server option; see section 4.6.2, Launching the Self-Service App with a specific server for details.

7. In the SSL Certificate Issuer DN box, type the Issuer DN of the client-side certificate used to authenticate the client to the server for two-way SSL/TLS.

   This is optional.

8. Click Next.
9. Click Install.
10. When the installer has completed, click Finish.

Note: The shortcut to the Self-Service App is created only for the current user.

2.2.1 Installing the Self-Service App silently

To install silently on a client PC, you can use the .msi installer with the following command-line parameters:

msiexec /i "<msi path>" /lv <LogFile> /q SSA_SERVERNAME=<ServerURL> SSLCERTIFICATEDN=<sslcertdn> INSTALLDIR=<InstallationFolder>

where:

• <msi path> is the path to the .msi file.

• <LogFile> is the name of the file to which you want to write a verbose log. This is optional.

• <server url> is the URL of the server on which the MyID Web Services are installed.

  Note: Make sure you use the correct protocol: http or https. Also, you must include the trailing slash (/).

• <sslcertdn> is the Issuer DN of the client certificate used to authenticate the client to the server for two-way SSL/TLS. This is optional.

• <InstallationFolder> is the name of the folder to which you want to install the application. This is optional.

Note: Do not put a space character on either side of the = sign in the command line.

For example:

msiexec /i "C:\install\<installer>.msi" /lv msilog.txt /q SSA_SERVERNAME=https://myserver/ INSTALLDIR="C:\temp\ssa"